---
layout: docs
page_title: 'nomad namespace list command reference'
description: |
  The `nomad namespace list` command displays a list of namespaces.
---

# `nomad namespace list` command reference

The `namespace list` command is used list available namespaces.

## Usage

```plaintext
nomad namespace list [options]
```

The `namespace list` command requires no arguments.

If ACLs are enabled, this command requires a management ACL token to view all
namespaces. A non-management token can be used to list namespaces for which it
has an associated capability.

## Options

- `-json` : Output the namespaces in their JSON format.

- `-t` : Format and display the namespaces using a Go template.

## Examples

List all namespaces:

```shell-session
$ nomad namespace list
Name      Description
default   Default shared namespace
api-prod  Production instances of backend API servers
api-qa    QA instances of backend API servers
web-prod  Production instances of webservers
web-qa    QA instances of webservers
```

## General options

@include 'general_options_no_namespace.mdx'
